.. _cemLtcQue_Alloc:

cemLtcQue_Alloc
===============
---------------


SYNOPSIS
--------


.. code-block:: none

  VT_I4 cemLtcQue_Alloc(
    VT_I4 Axis,
    VT_I4 QueSize,
    VT_I4 SrcCntr
  )



DESCRIPTION
-----------


- 대상 모션 축의 래치 카운터(Latch Counter) 의 큐(Queue) 버퍼를 지정한 크기로 설정합니다.
- 초기 버퍼 크기는 ‘0’ 으로 설정되어 있습니다.



PARAMETER
---------


- Axis : : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상,. (최대 통합 축 개수 - 1) 이하의 값을 축 번호로 설정할 수 있습니다. 

- QueSize : Queue 버퍼 크기. 최대 버퍼 크기는 1024 입니다. 

- SrcCntr : 저장할 대상 래치 카운터를 설정합니다. 

+-----------------+-----------------------------------------------+
| Value           | Meaning                                       |
+=================+===============================================+
| 0 (cemCNT_COMM) | 명령 위치 카운터. (Command position counter)  |
+-----------------+-----------------------------------------------+
| 1 (cemCNT_FEED) | 실제 위치 카운터. (Feedback position counter) |
+-----------------+-----------------------------------------------+
| 2 (cemCNT_DEV)  | Deviation 또는 펄스 출력 속도.                |
+-----------------+-----------------------------------------------+



RETURN VALUE
------------

+----------------+-----------+
| Value          | Meaning   |
+================+===========+
| 음수           | 수행 실패 |
+----------------+-----------+
| 0 (ceERR_NONE) | 수행 성공 |
+----------------+-----------+


Example
-------
.. code-block:: cpp
 :linenos:


 // 0 번 축의 래치 카운터의 큐 버퍼를 512 로 설정합니다.
 long nQueSize = 512;
 if(cemLtcQue_Alloc ( cemX1, nQueSize, cemCNT_FEED ) != ceErr_None)
 {
 OutputDebugString ( “cemLtcQue_Alloc function failed” );
 }